home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 26 / AACD 26.iso / AACD / Magazine / CDRipping / QuickSampler / QUICKSAMPLER_E.doc < prev    next >
Encoding:
Text File  |  1997-07-31  |  14.2 KB  |  378 lines
  1.  
  2.                              QUICKSAMPLER  ©
  3.                             -----------------
  4.  
  5.               A program for reading digital audio data (CDDA) out
  6.                              of CD-ROM drives.
  7.                    QUICKSAMPLER V1.5  © 1996/1997 by Mario Kubek
  8.                            ALL RIGHTS RESERVED!
  9.                         Version 1.5 July 30 1997
  10.                     Date of the last change: July 31 1997.
  11.                             Author: Mario Kubek
  12.                          This program is Freeware!
  13.  
  14. 1. The program
  15.  
  16.  1.1    Introduction        -  What is QUICKSAMPLER?
  17.  1.2    Requirements        -  Was is required to run the program?
  18.  1.3    Features            -  What special abilities does it have?
  19.  1.4    Installation        -  Where to put it to?
  20.  1.5    Functions           -  Descriptions of the GUI and the TOOLTYPES
  21.  1.6    Compatibility       -  Which drives have been tested?
  22.  1.7    Errormessages       -  Hope you will not see any of them!
  23.  1.8    Bugs                -  Yes, yes the bugs!
  24.  
  25. 2. History und future
  26.  
  27. 2.1    History of QUICKSAMPLER  - What is new in this version?
  28. 2.2    TO DO                    - What can be expected in the future?
  29.  
  30.  
  31. 3. Important additional information
  32.  
  33. 3.1    Author,Updates,Sourcecode,Registration - Get in contact!
  34. 3.2    COPYRIGHT NOTE and DISCLAIMER          - Please, read it!
  35.  
  36.  
  37. 4. THANKS
  38.  
  39.        THANKS  -  Thanks go to ...
  40.  
  41.  
  42.  
  43. 1.1 Introduction
  44.  
  45. QUICKSAMPLER is a program for reading digital audio data (CDDA) out
  46. of CD-ROM drives, which are capable of sending digital audio data
  47. (16 Bit) over the SCSI bus.
  48. This data can be saved in a file to a disk.
  49. This version works with TOSHIBA drives.
  50.  
  51. 1.2 Requirements
  52.  
  53. You need to run the program an AMIGA (that's clear) with at least a
  54. 68020 processor and a SCSI-Controller with CD-ROM drive, which is able of
  55. sending digital audio data (16bit) over the SCSI bus.
  56. Most drives do not support this feature. Take a look at the compatibility
  57. list to get to know, if your drive has this ability.
  58. I recommend the use of TOSHIBA drives. I own the TOSHIBA XM-5301B and
  59. it works great.
  60.  
  61. Kickstart 3.0 is required, but it should also work with Kickstart 2.xx
  62. (not tested).
  63.  
  64. 1.3 Features
  65.  
  66. QUICKSAMPLER V1.0 can/does...
  67.  
  68. ...save CDDA data (whole songs or part of songs) to a file in a very
  69.    FAST way.
  70. ...save the audio data in the fileformats: CDR, RAW, 8SVX
  71. ...convert the CDDA data to following samplerates: 44100 (44.1 kHz),
  72.    22050 (22.05 kHz), 14700 (14.70 kHz), 11025 (11.025 kHz)
  73. ...change the byte order (MSB [Motorola format] at first or LSB [Intel
  74.    fromat] at first) when saving 16bit data.
  75. ...change the audio channels in the file: STEREO, CHANGE STEREO
  76.    CHANNELSIDE (what you normally hear on the left speaker of the CD
  77.    is the right channel in the file and what you hear on the right
  78.    speaker is the left channel in the file), LEFT ON BOTH CHANNELS
  79.    (what you can hear on the left channel on a CD is what you get
  80.    on both channels in the file, the right one has no influence), RIGHT
  81.    ON BOTH CHANNELS (what you hear on the right channel on a CD is what
  82.    you get on both channels in the file, the left one has no influence),
  83.    MONO (the left and the right channel are summed up and devided by 2),
  84.    MONO_LEFT (you will get only the left channel in the output file),
  85.    MONO_RIGHT (you will get only the right channel in the output file).
  86. ...offer you a good looking process bar.
  87. ...tell you using the GUI how many bytes will have the output file.
  88. ...check before writing to disk, if there is still enough place.
  89.    Imagine you want to create a file, which is bigger than the available
  90.    free space on the disk. Then QUICKSAMPLER creates the audio file, sets
  91.    it's size, which is calculated with the help of intern routines. During this
  92.    process it can happen that the end of the disk is reached. In this
  93.    case QUICKSAMPLER closes and deletes the file, because it does not
  94.    make sense to write to a file, which wouldn't contain all the data
  95.    you wanted to have in it. Some other programs do not check the free
  96.    diskspace. They simply write the audio data to the file after they
  97.    have created it. So it could happen that during the writing process
  98.    (lets say 1 or 2 minutes later) the end of the disk is reached.
  99.    What now? The user loses time and audio data, which should be in the
  100.    file.
  101. ...not waste ram-memory. The allocated memory is determined using
  102.    the WB-tooltype "BUFBLOCKS" or with the CLI-Argument "BUBLOCKS".
  103.    BUFBLOCKS can be a number between 0 and 65. The smaller the number
  104.    is, the smaller is the allocated memory and QUICKSAMPLER must read
  105.    from the CD more often. The bigger the number is, the bigger is
  106.    the allocated memory and QUICKSAMPLER must read from the CD less
  107.    often. Default number is 32. There are 3 buffers that have to be
  108.    allocated. The sizes of them are calculated with the formula
  109.    (BUFBLOCKS*2352/a_number_between_1_and_17) or
  110.    (BUFBLOCKS*2352*2) when data in RAW 16bit STEREO 44.1 kHz are changed
  111.    (CHANNEL processing) and saved.
  112. ...offer you a fast reading and writing routine (also for STEREO 8SVX).
  113.    It is not so compulsory to write such a routine as you might think of.
  114.  
  115.  
  116. ATTENTION: The best quality 44.1 kHz is waste of diskspace, because
  117.            you normally hear tones (only) until approximately 20 kHz.
  118.            I suggest the samplingrate 22050.
  119.            A file with 22.05 kHz is half so big as a file with 44.1 kHz.
  120.  
  121. 1.4 Installation
  122. Simply drag the drawer of this program (it is the best if all additional
  123. files are in it e.g.: the documentations) where do you want to have it.
  124.  
  125.  
  126. 1.5 Functions
  127.  
  128. The program should be controlled by the following tooltypes:
  129.  
  130. DEVICE=<your_scsi_device>  Default is squirrelscsi.device.
  131. UNIT=<your_unit_number>    Default is 2.
  132. BUBLOCKS=<a_number_between_0_and_65> Default is 32.
  133.    The allocated memory is determined using
  134.    the WB-tooltype "BUFBLOCKS" or with the CLI-Argument "BUBLOCKS".
  135.    BUFBLOCKS can be a number between 0 and 65. The smaller the number
  136.    is, the smaller is the allocated memory and QUICKSAMPLER must read
  137.    from the CD more often. The bigger the number is, the bigger is
  138.    the allocated memory and QUICKSAMPLER must read from the CD less
  139.    often. Default number is 32. There are 3 buffers that have to be
  140.    allocated. The sizes of them are calculated with the formula
  141.    (BUBLOCKS*2352/a_number_between_1_and_17) or
  142.    (BUBLOCKS*2352*2) when data in RAW 16bit STEREO 44.1 kHz are changed
  143.    (CHANNEL processing) and saved.
  144.  
  145.  
  146. THE GUI:
  147. --------
  148. The all gadgets should be self-explaining.
  149.  
  150.             GADGET                FUNCTION
  151. ----------------------------------------------------------------------
  152. Sliders: - "TRACK"                Chosing of the audio track on the
  153.                                   CD, from which should be sampled.
  154.  
  155.          - "FROM"                 Gives the starting position for
  156.                                   sampling in minutes and seconds.
  157.  
  158.          - "TO"                   Gives the ending position for
  159.                                   sampling in minutes and seconds.
  160.  
  161. String:  - ""                     There you can enter the name of
  162.                                   the output file.
  163.                                   ALWAYS PRESS THE RETURN KEY after
  164.                                   you have entered the name of the
  165.                                   file or you will not be able to
  166.                                   sample. ("DO IT!" Gadget is still
  167.                                   ghosted.)
  168.  
  169. BUTTONS: - "FILE"                 A requester will appear in which you
  170.                                   can enter the name of your output file
  171.                                   with the path.
  172.  
  173.          - "DO IT!"               Press it and the sampling process
  174.                                   should start.
  175.                                   THIS BUTTON WILL ONLY BE ENLIGHTENED
  176.                                   IF YOU HAVE GIVEN A VALID OUTPUT FILE.
  177.                                   If your drive does not support the
  178.                                   of digital audio data, you will
  179.                                   receive an error message.
  180.  
  181.          - "ABORT"                Stops the sampling process.
  182.  
  183.          - "ABOUT"                Shows information of the program and
  184.                                   the author.
  185.  
  186. CYCLES:  - "CHANNELS"             Take a look at the features-list
  187.                                   to get to know the functions.
  188.  
  189.          - "FORMAT"               Changes the output format: RAW, CDR
  190.                                   (data with no loss of quality),
  191.                                   8SVX (IFF-Format 8 bit)
  192.  
  193.          - "BITS"                 Changes the bit-resolution (8/16bit)
  194.                                   when saving in the RAW-format.
  195.  
  196.          - "FREQ"                 Changes the frequency: 44.1 kHz,
  197.                                   22.05 kHz, 14.7 kHz, 11.025 kHz.
  198.  
  199.          - "MSB/LSB"              Changes the byte order when saving
  200.                                   in RAW 16bit.
  201.  
  202.  
  203. @endnode
  204.  
  205.  
  206.  
  207. 1.6 Compatability
  208.  
  209. CD-ROM drive             works y/n
  210. -----------------------------------
  211. -TOSHIBA drives                y
  212.  since 3401
  213.  
  214.  
  215.  
  216.  
  217. Others may work, but I haven't tested them! Try it with yours!
  218.  
  219. 1.7 Errormessages
  220.  
  221. There are many and various errormessages in the program. They are
  222. easily to understand and must not be explained here. In most
  223. cases when an error occures during the reading process, the sampling
  224. is stopped (for instance: if your drive does not support the function
  225. of reading digital audio data or when it is not compatible with the
  226. TOSHIBA drives or the command of reading digital audio is not
  227. compatible with your drive.
  228.  
  229. 1.8 Bugs
  230.  
  231. Currently none known.
  232.  
  233.  
  234. 2.1 History of QUICKSAMPLER
  235.  
  236. Version 1.00 (first release)
  237.  
  238. Version 1.5  (second release)
  239.  
  240. It includes...
  241.  
  242. ...a speed increased reading and writing routine.
  243.  
  244. ...a check, in which a routine determines automatically if there is
  245.    a CD in drive or even not (with the help of the timer.device).
  246.    In the previous version this check was performed using
  247.    IntuiMessages. But if your CD drive was not mounted, the program
  248.    could not receive an IDCMP_DISKINSERTED or IDCMP_DISKREMOVED
  249.    message. And if you have inserted or removed a CD, QUICKSAMPLER
  250.    could not recognize this diskchange and the display was not
  251.    updated with the data of another CD or it was not cleared if
  252.    no CD was inserted. Because of that you had to quit and restart
  253.    the program to make the diskchange visible.
  254.    This problem is now fixed. Now every 2 seconds the program
  255.    checks if there is a CD in drive or not.
  256.    Dieses Problem ist nun behoben.
  257.  
  258. ...the default-"device"-name "squirrelscsi.device", because in the
  259.    last version the predefined name "1230scsi.device" caused an 
  260.    error, which was the reason for the little fragment "ice", which
  261.    appeared, when you wanted to switch to 14700 Hz with the help of 
  262.    the Cycle-Gadget "FREQ". Somehow MaxonC++ has put the last part 
  263.    of the string "1230scsi.device", which is "ice", into textfield 
  264.    of the "FREQ"-Gadget, which should show "14700".
  265.    This is not a programming-mistake, but surely a compiler-bug,
  266.    because with the now intern used string "squirrelscsi.device"
  267.    this error did not appear any longer.
  268.    This problem is now fixed.
  269.  
  270. ...several intern improvements.
  271.  
  272.  
  273.  
  274. 2.2 TO DO
  275.  
  276. - support for more CD-ROM drives
  277. - audio (CDDA) play function
  278.  
  279.   If you have any wishes or ideas for the development of QUICKSAMPLER
  280.   it would be nice if you could get in contact with me
  281.  
  282.  
  283. 3.1 Author,Updates,Sourcecode,Registration
  284.  
  285. The program QUICKSAMPLER and this document are written by
  286.  
  287.                 Mario Kubek
  288.  
  289.  
  290. Mail to:                       Mario Kubek
  291.                                Lessingstr. 39
  292.                                D-07318 Saalfeld
  293.  
  294. Bugreports and ideas for improving this program are welcome.
  295.  
  296.  
  297. Where do I get the Updates?
  298.  
  299. Updates of QUICKSAMPLER you will find in the Aminet(Aminet/disk/cdrom).
  300.  
  301.  
  302. The proram is written in C. You can get the sourcecode if you send me
  303. a disk with your name.
  304.  
  305. If you find this program good, then you can send me a small fee
  306. about 15DM or US$10 in an envelope. But this is a "can" not a "must",
  307. because the program is freeware.
  308.  
  309. At the same time you will get the newest version of QUICKSAMPLER, when
  310. you have put a disk into an envelope, and you become a registered
  311. user.
  312.  
  313.  
  314.  
  315. 3.2 COPYRIGHT NOTE and DISCLAIMER
  316.  
  317. The program-packet consists of:
  318. documents: "QUICKSAMPLER_E.guide", "QUICKSAMPLER_E.doc"
  319.            "QUICKSAMPLER_D.guide" and "QUICKSAMPLER_D.dok"
  320. program:   "QUICKSAMPLER"
  321.  
  322.  
  323.  
  324. QUICKSAMPLER is Copyright © 1996/1997 by Mario Kubek
  325. QUICKSAMPLER_E.guide is Copyright © 1996/1997 by Mario Kubek
  326. QUICKSAMPLER_E.doc is Copyright © 1996/1997 by Mario Kubek
  327. QUICKSAMPLER_D.guide is Copyright © 1996/1997 by Mario Kubek
  328. QUICKSAMPLER_D.dok is Copyright © 1996/1997 by Mario Kubek
  329.  
  330.  
  331. All rights resered.
  332.  
  333. QUICKSAMPLER is Freeware. The author has the copyright for the
  334. program "QUICKSAMPLER" and for all the documentations to the executable.
  335. All rights reserved.
  336.  
  337. It may be distributed freely as long as
  338. no modifications are made to the executable and the documents. A small
  339. fee may be asked to cover distribution costs.
  340.  
  341. QUICKSAMPLER may not be used for any commercial purposes or included
  342. with any commercial product without the written permission of the author.
  343.  
  344. The author can not guarantee, that the program will function on your
  345. computer.
  346. The author takes NO responsibilities for damaged Amigas, CD-ROM drives
  347. or any other components or data involved while using QUICKSAMPLER or
  348. while using the documentations.
  349.  
  350. Your are using it at your own risk.
  351. There is no guarantee for further updates. There is also no
  352. guarantee, that bugs are removed in them.
  353.  
  354. The program-packet is also free of rights of third persons.
  355.  
  356. NOTE: In almost all cases it is NOT legal to copy any CD.
  357.       That includes, that no digital audio data are read from a CD.
  358.       Though you own the CD you do not own the rights for the CD.
  359.       Please do NOT violate existing rights. You are responsible for
  360.       it.
  361.  
  362.  
  363. 4  THANKS
  364.  
  365. Thanks must go to:
  366.  
  367. - Thomas Wenzel for his great program Play16!
  368.  
  369. - TOSHIBA for the best und fastest CD-ROM drives!!!
  370.  
  371. - MAXON for the great C++ Compiler MaxonC++ 4.0 Dev. Professional.
  372.   MaxonC++ is Copyright © 1996 by MAXON Computer GmbH.
  373.  
  374. - Phase 5 for the fastest turboboards and SCSI-Controllers for the
  375.   AMIGA.
  376.  
  377. - Malcolm Harnden for the five great CDs
  378.